home *** CD-ROM | disk | FTP | other *** search
/ Mac Magazin/MacEasy 32 / Mac Magazin and MacEasy Magazine CD - Issue 32.iso / Multimedia / MIDI / Midi Typer Distribution / !Read Me! next >
Text File  |  1997-03-20  |  12KB  |  215 lines

  1.  
  2.  
  3.  
  4.  
  5. Midi Typer
  6. (Version 1.0.6)
  7.  
  8. 1. What is it?
  9.  
  10. The short answer
  11.  
  12. Midi Typer is a drag-and-drop utility. It convinces your system that all those MIDI files you have really are MIDI files. This is often a problem with MIDI files created for other computer systems, even though the data format for MIDI files is identical for all systems. 
  13.  
  14. Midi Typer is smart enough to distinguish between real MIDI files and other kinds of documents, so you can just drop the icon of a folder or disk on Midi Typer, and it will automagically do the rest. Most similar utilities will not take any precautions of this sort. If Midi Typer doesn't change a document's icon, then it isn't a MIDI file. You can also use Midi Typer to change the application that will open your Midi Files. 
  15.  
  16. Midi Typer requires System 7.0 or greater.
  17.  
  18. Please do not confuse Midi Typer with other, similarly named, utilities. Please do take a moment to look at this text, at least the portions in larger (12 point) type. It will answer most questions ever asked.
  19.  
  20. The long answer
  21.  
  22. Macintosh users who download MIDI files (or buy them from commercial collections) are often faced with the problem that their MIDI software refuses to recognize the downloaded file—they won’t even show up in the standard Open File dialog. The problem is that the Finder thinks your MIDI files are really text-only documents. (This description is somewhat simplified; the “How does it really work?” section goes into more detail.) 
  23.  
  24. You can, of course, solve this problem by using any of a number of utilities (exempli gratia ResEdit), but you have to manually change information for each file individually. With Midi Typer, you just drag a bunch of icons onto Midi Typer and it does the rest. You can also specify an application to open your Midi Files with, so that you can double-click on the Midi File and have it opened in your favorite sequencer, notation program, or Max.
  25.  
  26. There are other utilities for automatically changing file types. Midi Typer is unique in that it actually looks at the data in your file to check if it is, indeed, a MIDI File. There’s no point in trying to open a “Read Me” document with your sequencer. 
  27.  
  28. 2. How much does it cost?
  29.  
  30. Nothing. You must, however, read Section 7 (“Legal Stuff”) before you may use Midi Typer. 
  31.  
  32. 3. How does it work?
  33.  
  34. Pretty much the way you'd expect. Drag file, folder, or disk icons onto Midi Typer's icon.
  35.  
  36. Configuring Midi Typer
  37.  
  38. The first time you use Midi Typer, you should open the application directly (either select Midi Typer and choose Open from the File menu or double-click on Midi Typer’s icon). You can choose which MIDI program you want to open your MIDI files with from the Open With menu (Figure 1). 
  39.  
  40.  
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.  
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.  
  71.  
  72.  
  73.  
  74.  
  75.  
  76.  
  77.  
  78.  
  79.  
  80.  
  81.  
  82.  
  83.  
  84. If your MIDI program is not listed in the menu, choose Select Other Application…, and you can specify any application you want to in a standard Open File dialog (Figure 2).
  85.  
  86.  
  87.  
  88.  
  89.  
  90.  
  91.  
  92.  
  93.  
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107. Once you’ve specified which MIDI Application to use, go back to the Finder, select your Midi Files, drag them over to Midi Typer, and when Midi Typer’s icon is highlighted, just drop ’em. When you’re finished with Midi Typer, you can quit the application.
  108.  
  109. Once you’ve specified your sequencer, you can just drag-and-drop files, folders, and even entire disks onto Midi Typer. It will make all the necessary changes and quit automatically. If you ever want to change the application used to open your Midi files, just open Midi Typer and make the appropriate choice in the Open With menu.
  110.  
  111. If you would like to see improvements made, write to me. My address is at the end of this document. Don’t expect too much—this is a freeware project.
  112.  
  113. 4. How does it really work?
  114.  
  115. The following information is of a technical nature. You do not need to understand it to use Midi Typer.
  116.  
  117. The problem with most downloaded MIDI files (and with MIDI files taken from other systems) is that the files have the OSType 'TEXT' instead of 'Midi' in the file type field of the Finder Information record. Midi Typer looks at every file dropped on it and, if the first 20 bytes comprise a valid MIDI file Header Chunk, changes the file type and creator fields. I considered making Midi Typer look at the entire file, but all MIDI software I know of makes sanity checks while interpreting MIDI Files, so the chosen solution seems satisfactory. It is also fast enough that a progress dialog is not absolutely necessary. 
  118.  
  119. Midi Typer is based on Paul Hoffman’s Dragonsmith application framework (v. 1.1.1) and was developed using Think C (v. 6.01). You can find Dragonsmith at a number of archive sites—try the Info-Mac archives at Sumex-aim (ftp://sumex-aim.stanford.edu/) or the archives at University of Michigan. Dragonsmith relies several on several System 7.0 features (in particular, Apple Events).
  120.  
  121. 5.    Where can I find the latest version?
  122.  
  123. The reference (i.e. most up-to-date) version is maintained at ftp://ftp.prz.tu-berlin.de/pub/MusicAnalysis/Utilities/
  124.  
  125. (The server is a Unix machine, so watch the capitalization on the path!).
  126.  
  127. Midi Typer (not necessarily the latest version) is also available at Info-Mac and U. Michigan archives (and their mirror sites), the Opcode ftp site, and the MotU-Mac Website. It has also been included on CD-ROMs published by MacWorld España, the IEEE, and others. I maintain a list of links at my WWW Site, the links should be at http://www.prz.tu-berlin.de/~pcastine/Music/programs.html
  128.  
  129. 6.    Limitations and room for improvement
  130.  
  131. •    No progress indicator. Not a problem for ten to twenty files, but if you drop your hard disk on Midi Typer, the program will need some time. At least it works cooperatively in the background and you can interrupt it with Command-Period. And I get over 10 files/second on an old IIfx.
  132.  
  133. •    Similarly, no notification of errors. 
  134.  
  135. •    Midi Typer trusts you when you select an application using the Select Other Application command. If you tell it that you want to open your MIDI files with Excel, it will obediently do so. I have no idea what Excel will do with a MIDI file. 
  136.  
  137. •    Midi Typer does not recognize Aliases to applications in the standard File Open dialog (Select Other Application command). 
  138.  
  139. •    Midi Typer has no Open command in the File menu. The only way to initiate file processing is with drag-and-drop. 
  140.  
  141. •    Midi Typer will not go further than twenty levels deep when looking at folders within folders within folders. This prevents problems that can arise if you put an alias to a folder inside the folder the alias points to (if you know what infinite recursion is, you’ll recognize the problem).
  142.  
  143. •    Midi Typer is still pure 68k code. As long as most of the File System is emulated, there's not much point in generating PPC code—it would just make Midi Typer fatter, not faster. I note that all similar utilities—even the popular File Typer—are still, as late as 1997, 68k code only.
  144.  
  145. •    Some future version of Midi Typer may offer you an option to strip off those stupid .MID suffixes from the file name.
  146.  
  147. • Warning: If you used a pre-release version of Midi Typer, you must delete the old Preferences file (inside the Prefences folder in your System Folder). It is incompatible with this version of Midi Typer.
  148.  
  149. Judging from the responses I've gotten over the past three years, nobody really needs any of these features. Or maybe nobody reads documentation anymore? (Ha ha! Now I can do all sorts of Dave Barry-style insults! But, no! Surely everyone reads the licensing information?!? Maybe I'll include a clause in the next version requiring that the user offer me his or her first-born…)
  150.  
  151. 7.    Legal Stuff
  152.  
  153. •    Copyright
  154.  
  155. Midi Typer (the program and accompanying documentation) is Copyright © 1994-97 by Peter Castine. All rights reserved.
  156.  
  157. •    License
  158.  
  159. Midi Typer (the Software) is provided by Peter Castine (the Author) free of charge and may be distributed free of charge, provided that this documentation is included unchanged with the software. YOU MAY NOT SELL THE SOFTWARE, NOR MAY YOU TAKE A FEE OR COMMISSION FOR PROVIDING THE SOFTWARE TO ANOTHER PERSON, NOR MAY YOU INCLUDE THE SOFTWARE WITH OTHER SOFTWARE THAT IS SOLD FOR A FEE WITHOUT PRIOR WRITTEN PERMISSION FROM THE AUTHOR. 
  160.  
  161. Permission is herewith granted for making the software available on electronic data services (‘Bulletin Boards’) and FTP-Archive Servers providing that the documentation and software are included without change or abridgment.
  162.  
  163. License arrangements for bundling in other cases are easy, but you must contact me.
  164.  
  165. •    Disclaimer of Warranty on Software
  166.  
  167. THE SOFTWARE IS PROVIDED “AS IS” AND WITHOUT WARRANTY OF ANY KIND. The Author expressly disclaims all warranties, express or implied, including, but not limited to, the fitness for a particular purpose. The Author does not warrant that the software will be uninterrupted or error-free, or that defects in the software will be corrected. Furthermore, the Author does not warrant or make any representations regarding the use or the results of the use of the software  in terms of their correctness, accuracy, reliability, or otherwise. No oral or written information or advice given by the Author shall create a warranty or in any way increase the scope of this warranty. Should the software prove defective, you (and not the author) assume the entire cost of all necessary servicing, repair or correction of the software, or the computer system with which it is used.
  168.  
  169. •    Limitation of Liability
  170.  
  171. UNDER NO CIRCUMSTANCES, INCLUDING NEGLIGENCE, SHALL THE AUTHOR BE LIABLE FOR ANY INCIDENTAL, SPECIAL, OR CONSEQUENTIAL DAMAGES THAT RESULT FROM THE USE OR INABILITY TO USE THE SOFTWARE, EVEN IF THE AUTHOR HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES.
  172.  
  173. That’s it. Note that, at the time of this writing, I have every reason to believe that the software will work as advertised and that it will not cause any damage. I just cannot test it on every possible Macintosh configuration, so, caveat emptor.
  174.  
  175. 8. Praise, Complaints, Offers of jobs…
  176.  
  177. Send them all to:
  178.  
  179. Peter Castine
  180. Wildganssteig 28
  181. 13503 Berlin
  182. Germany
  183.  
  184. e-mail:    pcastine@prz.tu-berlin.de
  185.  
  186. (You may also want to check out my WWW Site at http://www.prz.tu-berlin.de/~pcastine) 
  187.  
  188. If your favorite MIDI program is not currently on the menu, you can send me a postcard or e-mail with the program’s name and creator code. I’ll get it into the next version of Midi Typer. If you send the information by e-mail, I’ll e-mail the new version back to you. 
  189.  
  190. And special thanks to the folks who've sent postcards, e-mail, etc!
  191.  
  192. 9. Update notes
  193.  
  194. Not very precise, but there've been more important things to do…
  195.  
  196. v. 1.06 (20 March 1997): Added several more applications to the Open With menu. Wish I hadn't bothered with the 1.05 release.
  197.  
  198. v. 1.05 (18 March 1997): Added FreeStyle to Open With menu.
  199.  
  200. v. 1.04 (1 June 1996): Added Overture and Finale 3 to the Open With menu, (distinguishing Fin3 from earlier versions), updated documentation, dropping MS-Word version of documentation in the process (SimpleText's styled text is good enough, and who wants to maintain two versions of documentation?)
  201.  
  202. v. 1.03  (1995 or early 96): Added MidiJukebox to the Open With menu.
  203.  
  204. v. 1.02 (June 26, 1994): Added an item or two to the Open With menu
  205.  
  206. v. 1.01 (May/June 1994): Added Cubase (I think) to the Open With menu
  207.  
  208. v. 1.0 (May 13, 1994): First “public” release
  209.  
  210. v. 1.0 beta (late Apr. 1994): Beta test release. It shouldn't have gone outside of Berlin, but it was on a file server, so who knows where it got to?
  211.  
  212. -------------------------------------------
  213. 20 March, 1997        Midi Typer Documentation
  214.  
  215.